This PMSAM routes mail between AOCE and Internet-based mail accounts. It uses the SMTP (Simple Mail Transfer Protocol) to send mail and the POP (Post Office Protocol version 3) to fetch mail. It is an on-demand gateway, meaning that it will download messages to the Mac immediately instead of waiting for the user to open them.
The PMSAM has been written as a background only application, and its associated address and setup Directory Extension Templates are included in the PMSAM file itself, so it has a one step installation process.
Requirements
------------
AOCE 1.0b6 or later client software
MacTCP 1.1.1 or later pre-configured (not included)
An account on a TCP/IP based mail host running POP and SMTP and a connection to that host
How to install
-------------
1) Drag the file "Internet PMSAM" to your Extensions Folder and reboot.
2) Next, open the "AOCE Setup" control panel and click on the "Add..." button. You'll get a dialog asking what service to add. Select the "Internet Mail Service" item and click OK.
3) A new icon, called Internet Service will appear in the Setup list. To open it, double click it or select it and click Open.
4) The configuration window for the PMSAM will now appear. You need to fill in your user name on the mail host and your password (click the password button and type it in) first.
5) For SMTP server and POP server, enter the IP hostnames that are used for sending mail and receiving mail respectively. Check with your system administrator if you aren't sure what to put here. For best results, you probably want to set these to the same host.
6) Enter the send interval and receive interval in minutes. This is how often the MSAM will contact the remote hosts to send outgoing mail and to receive incoming mail. Leaving these values at 1/1 is a bad idea except for debugging, since checking for mail may be a time consuming process. 15 minutes or half an hour should be sufficient. Also, and messages you send from your Mac will be sent out through SMTP immediately.
7) Close the window
8) reboot your Mac
How to change your setup information
----------------------------------
If you want to change your setup information (if your name or password changes, or you want to change send/receive times/etc...), you can do this through the same procedure as above.
1) Open the Collaboration Setup control panel.
2) Double-click the Internet Service icon.
3) edit your configuration information (note that your old password is required to change your password.
4) close the window. no need to reboot this time
How to use it
------------
Once configured, any mail residing on your Internet mail account will be fetched by the PMSAM and will appear in your inbox. You can send messages by replying to messages routed by the PMSAM, by using the type-in addressing feature in the Mailer, or by creating new addresses in the Personal Directory via the included built-in address template.
Other Info
----------
The sample compiles with both Think C 5.0.x and MPW C.
MacsBug debugger breaks have been left in for your debugging convenience, meaning MacsBug (or another debugger or that type) is required to get the compiled version to run. If you want, you can undefine kDEBUG, which should build without any debugger breaks.
The PMSAM will only send and receive mail when the AOCE Master Key is unlocked. If you're writing your own PMSAM, you should normally continue routing mail even when the identity is locked if possible.
Messages of greater than 32k will not be routed in this version.
Only text is handled, and enclosures aren't sent, and text is submitted in TEXT blocks, with no linefeeds or font information. The letter application will format all of these blocks in Geneva 12 (maybe it's envious of TeachText?)
If you continue to receive the same message or messages over and over, or if you get a "password is incorrect" report, you may have zombie pop server clients running on your UNIX box. To fix this, log into your UNIX account using Telnet, then type "ps -aux | grep pop", and look for POP server processes with your user name. If you find one or more, kill them using the UNIX kill command and try again. Also, if the MSAM gets caught on a message it can't process, it will try it over and over. You may have to delete such messages manually.
This has only been written as sample code for developers, not for high volume production use, explaining some of the features it doesn't support.
Product is packed by weight rather than volume. During shipping, contents may have settled, rendering product inedible.
Questions/Comments
-------------------
As with the other AOCE samples, technical questions should be addressed to DEVSUPPORT if you're a supported AOCE seed site.
